home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / programr / tdwgui.zip / OPTIONS.TXT < prev    next >
Text File  |  1993-09-10  |  7KB  |  138 lines
  1. -- TDWGUI.DLL Options --
  2.  
  3.   TDWGUI.DLL is a DLL that allows TDW to display itself in a
  4.   pseudo-window on the screen.  In reality the DLL simply draws the
  5.   the TDW characters on the desktop using TextOut and other GDI
  6.   functions.  Since there is no video mode switching and the Windows GDI
  7.   system is used for device independance, TDW can be used on any video
  8.   adapter that Windows 3.x can run on.  The only real limitation is that
  9.   is must be at least a 386 machine.  If the DLL attempts to load on a
  10.   286 or lower, it will fail with an error message.
  11.  
  12. Allowable options in the [VideoOptions] section of TDW.INI for TDWGUI.DLL
  13.  
  14. DebugFile=ss            ss= path and name of logging file.
  15.  
  16. ForceFileSave=Y|N       Y Forces the log file to be written after each line.
  17.                         N (default) opens then file when the DLL is
  18.                         loaded, and closes it when unloaded.
  19.  
  20. Rows=xx                 xx= 25, or 50.  Specifies the initial mode for
  21.                         TDW to start up in.  This option only cares
  22.                         about the mode (25 or 50), NOT the number of
  23.                         lines (see MaxLines to specify the number of
  24.                         lines you want to use in "43\50" line mode).
  25.                         This option is for compatibility with the 3.0
  26.                         and 3.1 versions of TDW.
  27.                         (Default = 25)
  28.  
  29. FontSize=xx             xx= requested point size for the font. (default=10)
  30.  
  31. FontName=ss             ss= a string specifing the name of the requested
  32.                         font. The font must be fixed width and use the
  33.                         OEM character set.  TDWGUI.DLL calls CreateFont
  34.                         with this font name after matching the selected
  35.                         point size with the fonts availible from
  36.                         EnumFonts.  If it does not find a
  37.                         usable font with these attributes, it defaults
  38.                         back to the TERMINAL font.  ie:
  39.  
  40.                           FontName=TERMINAL
  41.  
  42.                         The matching process goes like this; of all the
  43.                         fonts in the specified font name:
  44.  
  45.                           1. Look for fixed pitch & OEM charset
  46.                           2. Then for an exact point match
  47.                           3. Else look for nearest point match
  48.                           4. Else use OEM_FIXED_FONT
  49.  
  50.                         Nearest point match is defined as the first font
  51.                         that is the closest in points the the requested
  52.                         point size.  Use the LogEnums=1 switch to see
  53.                         the list of fonts availible to TDWGUI.
  54.                         If more than one font matches the selected point
  55.                         size, the first one will be selected.  In order
  56.                         to select one of the other fonts that also
  57.                         match, an index override switch is provided.
  58.                         The EnumIndex=xx switch can be set to the index
  59.                         number that is listed in the 'Enumerated Fonts
  60.                         List' in the logfile.  This will then be the
  61.                         exact font selected (assuming that the specified
  62.                         index exists in the list).
  63.  
  64.                         TrueType fonts cannot be used and are not listed
  65.                         in the font list.  They can be forced to be
  66.                         listed with the LogTTs=Y switch, even though
  67.                         they cannot be indexed, matched, or used by TDWGUI
  68.  
  69. LogEnums=Y|N            Logs the availible fonts to the DebugFile.
  70.                         (Default = N)
  71.  
  72. LogTTs=Y|N              Also logs the TrueType fonts in the DebugFile
  73.                         (NOTE: TrueType fonts can NOT be used or
  74.                         specified for TDWGUI)
  75.                         (Default = N)
  76.  
  77. EnumIndex=xx            xx= Index of font to use from the font list in
  78.                         the DebugFile. (see LogEnums and FontName above)
  79.                         (Default = -1 which disables this feature)
  80.  
  81. TimerRez=xx             xx= number of miliseconds between updates of the
  82.                         TDW screen.
  83.                         (Default = 55, range = 55 - 5000)
  84.  
  85. MaxLines=xx             xx= the number of lines to use when TDW goes
  86.                         into 43/50 line mode.  anything over 100 is set
  87.                         back to 100.  (See also Rows)
  88.                         (Default = 50)
  89.  
  90. PosX=xx                 xx= horizontal position of TDW "window". -1 to center.
  91.                         (Default = -1)
  92.  
  93. PosY=xx                 xx= virtical position of TDW "window". -1 to center.
  94.                         (Default = -1)
  95.  
  96. BorderWidth=xx          xx= the width in pixels for the 3D border.
  97.                         if -1 is specified, 6 is used for the 3D border.
  98.                         (default = -1)
  99.  
  100. RestartGDI=Y|N          Y - re-initializes GDI when the DLL exits
  101.                         N - doesn't (default).  This is only needed if
  102.                             the color palette or mouse looks corrupted
  103.                             when the debugger exits. (usually on S3
  104.                             cards)
  105.  
  106. CursorMethod=B|F        B = BIOS call, F = Function call.
  107.                         With TDW 3.1, use B to make the cursor show up.
  108.  
  109. -------------------------------------------------------------------------------
  110.   Explanation of the 'Enumerated Fonts List' in the DebugFile
  111.  
  112.  In this example, FontSize was set to 10, and font #0 was the first one
  113.  that came the closest to that size.  In order to use font #2 (12x5),
  114.  you would need to set EnumIndex=2.
  115.  
  116.  Enumerated Fonts List [EnumIndex Mode]:
  117.  0 TERMINAL         h:12 w: 8 p: 9 c:1  fx:1 oem:1   [Near]
  118.  1 TERMINAL         h: 6 w: 4 p: 4 c:6  fx:1 oem:1
  119.  2 TERMINAL         h:12 w: 5 p: 9 c:1  fx:1 oem:1
  120.  3 TERMINAL         h: 8 w: 6 p: 6 c:4  fx:1 oem:1
  121.  ┬    ┬             ┬    ┬    ┬    ┬     ┬    ┬
  122.  │    │             │    │    │    │     │    └──── OEM or ANSI character set
  123.  │    │             │    │    │    │     │
  124.  │    │             │    │    │    │     └───────── Fixed or Proportional
  125.  │    │             │    │    │    │
  126.  │    │             │    │    │    └─────────────── Closeness matching factor
  127.  │    │             │    │    │
  128.  │    │             │    │    └──────────────────── Point size
  129.  │    │             │    │
  130.  │    │             │    └───────────────────────── Width in pixels
  131.  │    │             │
  132.  │    │             └────────────────────────────── Height in pixels
  133.  │    │
  134.  │    └──────────────────────────────────────────── Facename of font
  135.  │
  136.  └───────────────────────────────────────────────── Index for EnumIndex switch
  137.  
  138. -------------------------------------------------------------------------------